home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / prog / pi47u.zip / MANUAL.DOC < prev    next >
Text File  |  1992-06-12  |  61KB  |  1,357 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                      Program Installer Professional
  16.                              Version 4.7
  17.                         Official Release (06/92)
  18.  
  19.                      Copyright (C) 1990, 1991, 1992
  20.                           The DataWorks, Inc.
  21.                          2115 University Blvd.
  22.                              P.O. Box 20962
  23.                        Tuscaloosa, Alabama 35401
  24.                              (205) 345-2848
  25.                       
  26.                       (800) 992-6698 (orders only)
  27.                       
  28.                           (205) 345-5655 (Fax)
  29.                      
  30.                      (205) 507-0015 (BBS, HST 14.4)
  31.  
  32.  
  33.                               User's Manual
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                              Disclaimer
  57.  
  58.  
  59.      The DataWorks, Inc. makes no warranties or claims to the fitness of this
  60. program. The user of this program, makes use of this program accepting any
  61. and/or all responsibilities for the actions of this program.
  62.  
  63.      Though we at DataWorks have taken every measure possible to insure that
  64. the program will/does function properly and will not cause any loss or
  65. contamination to your data, we cannot accept responsibility for unexpected
  66. bugs or other problems with the program that could result in the loss of or
  67. contamination of your data.
  68.  
  69.      If you do experience problems (bugs!) with the program, we would like to
  70. know, and ask that you contact DataWorks directly, or through our support BBS.
  71.  
  72.  
  73.  
  74.                               Acknowledgements
  75.  
  76.      Special thanks to Bob Ainsbury (TechnoJock Software) for the best online
  77.      phone support ever.
  78.  
  79.      Kim Kokkenen, President of and Developer for TurboPower Software, for
  80.      a fine selection of toolkits and great technical support.
  81.  
  82.      Borland International for a superior product and great support staff.
  83.  
  84.      Barry Weck, co-developer of Program Installer.
  85.  
  86.      The staff at DataWorks, Inc. for putting up with us programmers!<G>
  87.  
  88.  
  89.  
  90.      ■ Borland is a registered trademark of Borland International
  91.      ■ Turbo Pascal is a registered trademark of Borland International
  92.      ■ Async Professional is a registered trademark of
  93.        TurboPower Software
  94.      ■ TechnoJock's Turbo Toolkit is a registered trademark of
  95.        TechnoJock Software.
  96.      ■ PKZip/PKUnZip are registered trademarks of PKWare, Inc.
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.                               Introduction
  112.  
  113.      Program Installer is simply that - a program installer. It has been used
  114. by DataWorks, Inc. in some of our own third party applications as a generic
  115. installation utility.
  116.  
  117.      Program Installer is designed for programmers/ 3rd. party developers. You
  118. can use it to facilitate the installation of a program you have written for
  119. either a client or for some vertical market. Program Installer doesn't care
  120. about what you have written or whether or not you want the program(s) you have
  121. written installed into a particular directory on the client/customer's hard
  122. drive.
  123.  
  124.      Program Installer can read files from either the A: or B: floppy diskette
  125. drive, and allows the end-user to specify the hard drive letter (C: through Z:)
  126. and/or subdirectory(s) into which your programs should be copied. All you, as
  127. a programmer/distributor, need to do is follow the simple setup instructions of
  128. Program Installer, and then let Program Installer do the rest for you (and
  129. your client/customers)!
  130.  
  131.      Program Installer not only copies files from the diskettes you setup for
  132. distribution, it can also handle subdirectories you may need created (nested)
  133. on the end-user's (client's) harddrive, and also provides for updating the
  134. end-user's AUTOEXEC.BAT and CONFIG.SYS files dynamically - all this totally
  135. transparent to the end-user.
  136.  
  137.      Also, Program Installer provides options that allow you a limited amount
  138. of license protection for your application. Even data encryption has been
  139. implemented (beginning with version 3.0) so you can be assured that your
  140. programs/data cannot be installed (or just copied) without the use of Program
  141. Installer.
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.                                FEATURES!
  167.  
  168.  
  169.         ■ The ability to configure Program Installer for each
  170.           product you want to use it with. By "configure" we
  171.           mean you can specify the number of times INSTALL can
  172.           be executed, whether or not the installation is to be
  173.           protected, if the installation process is to be protected,
  174.           you can use encryption on the files to be installed.
  175.           And this configuration can be changed time and time again!!!
  176.  
  177.           Best of all, you can also have Program Installer replace
  178.           every/all occurrences of The DataWorks, Inc. copyright
  179.           messages with anything you want to appear in its menus/
  180.           screens.
  181.  
  182.         ■ With Version 4.7 you can now replace every occurrence of the
  183.           Program Installer Professional name.
  184.  
  185.         ■ The incorporation of the .LZH compression method, providing
  186.           the ability to compress your application on the distribution
  187.           diskette(s) (beginning with v4.0beta).
  188.  
  189.         ■ Seamless interface. Program Installer is written in
  190.           Borland's <tm> Turbo Pascal 6.0 using Turbo TechnoJock's <tm>
  191.           TTT5 ToolKit, and Async Professional <tm> by TurboPower Software.
  192.           The code has been tested thoroughly for bugs and performs fast,
  193.           efficient, and with a professional appearance. We feel this is
  194.           important because the first impression of your product is its
  195.           installation process and first impressions can definitely be
  196.           long lasting.
  197.  
  198.         ■ Easy setup. Program Installer takes only minutes to
  199.           completely configure for your use.
  200.  
  201.         ■ Free technical support from 9:00 A.M. to 5:00 P.M.
  202.           central standard time (USA).
  203.  
  204.  
  205.                TECHNICAL SUPPORT (Registered Users Only!)
  206.  
  207.           Support is provided in all of the following ways:
  208.  
  209.                Direct voice contact: (205) 345-2848
  210.  
  211.                24 hours a day by:
  212.  
  213.                     CompuServe ID#: 71321,3422
  214.  
  215.                     DataWorks BBS! (205) 507-0015
  216.  
  217.                     Or Dev-Net (DW-PRODS conference)
  218.                     on a local technical BBS in your
  219.                     area, who is echoing the Dev-Net
  220.                     QWK/Fido mail compatible netmail
  221.                     conferences.
  222.                     
  223.  
  224.  
  225.  
  226.      IMPORTANT NOTICE FOR TEST DRIVE (Non-registered) VERSION/USERS
  227.  
  228.      If you have not registered your copy of Program Installer, some of
  229. the following features will not work because they are disabled in the
  230. TEST DRIVE release of all copies of Program Installer. Prior to version 4.0beta,
  231. we totally disabled almost all of the advanced features of the program until
  232. the user registered the program. With the release of 4.5 and later versions,
  233. we are allowing for all features to be available except for the following:
  234.  
  235.         ■ You will not be able to remove any of the hard-coded
  236.           "Copywrite (C)" information lines out of the program
  237.           and replace them with your own.
  238.  
  239.         ■ You will not be able to remove any of the hard-coded
  240.           'Program Installer Professional' titles from the
  241.           program.
  242.  
  243.         ■ Although you will be able to actually work with ALL features
  244.           of the product, you will only be able to build one (1)
  245.           installation diskette for distribution. Hence, you
  246.           can actually use the product if your application
  247.           requires only one diskette for distribution.
  248.  
  249.  
  250.      We effected these disabilities this way because this will allow you,
  251. the distributor/developer to preview all of the program's features/options,
  252. and review the integrity/performance of the program all the way to the point
  253. of actually creating your distribution diskettes. However, the INSTALL.EXE
  254. will only allow you to install one diskette until you actually register the
  255. program.
  256.  
  257.                          NOTICE!!!   NOTICE!!!
  258.  
  259.      We at DataWorks, Inc. know that Program Installer is a high-quality,
  260. commercial product. However, instead of releasing Program Installer at
  261. $199.95 or higher, to compete with other comparable commercial products,
  262. we're releasing it via the BBS community for a very modest fee. Because of this
  263. we MUST disable the program, forcing users to pay for its use. There are a
  264. number of ways available for registering the program and obtaining a
  265. REGISTER.KEY file. See the REGISTER.DOC file for details. Our main reason for
  266. distributing the program this way, and at such a price is because we know
  267. that many, many developers out there don't want to spend $200.00 and up
  268. to use an installation utility only once! Also, for distributors/developers
  269. that DO have several products they want to use the installation utility for,
  270. we're providing an excellent product at an excellent price! By doing this,
  271. we hope to make every user of Program Installer happy!!!
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.                         SETUP AND CONFIGURATION
  284.  
  285.  
  286.      When you first receive Program Installer it needs to be configured for use
  287. with your application(s). This is accomplished easily!
  288.  
  289.      Program Installer's main program - INSTALL.EXE - is the only program that
  290. you'll ever use. This may seem a bit confusing, but the program modifies itself
  291. each time you configure it for your software and distribution. This means that
  292. once you configure it for use with say, a product you're selling that you don't
  293. care about copy protection for, and it has only 4 disks, that you're not locked
  294. into THAT configuration, period. Program Installer is designed to be configured
  295. again, and again. So, whether you're wanting to use it for only one application
  296. you're marketing/distributing, or with many different applications, it's quite
  297. easy to configure it for each application! Best of all, you only have to buy
  298. one copy of the program to do all this! No royalties, no nothing.
  299.  
  300.  
  301.          
  302.                       REPLACING OUR COPYRIGHT LINES
  303.  
  304. ■ (06/11/92) - See notes at end of this document for update to this
  305.                part of the setup. You can now change the actual name
  306.                'Program Installer Professional' to the name of your
  307.                own installation program!
  308.  
  309.      The first thing most users want to do is get rid of DataWorks' copyright
  310. information that appears throughout the program. To do this, make sure you are
  311. in the directory that INSTALL.EXE is in. Then type
  312.  
  313.         INSTALL LICENSEE - and press <Enter>.
  314.  
  315.      Program Installer will look for your REGISTER.KEY file in the same
  316. directory you are executing the INSTALL.EXE file in. (NOTE: If you have NOT
  317. registered your copy of Program Installer, you will not have this file!) If
  318. Program Installer finds the REGISTER.KEY file, then it proceeds and allows
  319. you to continue.
  320.  
  321.      The screen that appears is simple. You're prompted to enter the name -
  322. however you want it! - that you want to appear instead of the DataWorks, Inc.
  323. copyright information that appears throughout the program.
  324.  
  325. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  326. ░╔═════════════════════════════════════════════════════════════════════════╗░
  327. ░║ ······································································  ║░
  328. ░╚═════════════════════════════════════════════════════════════════════════╝░
  329. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  330.  Figure 1
  331.  
  332.  
  333.      After you enter the name (or complete line of information) and press
  334. <Enter> (or <RETURN> on some machines) you will be prompted to verify that the
  335. data you entered is, in fact, what you want to use in place of the DataWorks,
  336. Inc. copyright information.
  337.  
  338.  
  339.  
  340.  
  341.  
  342.         ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  343.         ░░╔═══════════════════════════════════════════╗░░
  344.         ░░║              You entered...               ║░░
  345.         ░░║ Copyright (C) 1991 - The DataWorks, Inc.  ║░░
  346.         ░░║                                           ║░░
  347.         ░░║               Accept  Redo                ║░░
  348.         ░░╚═══════════════════════════════════════════╝░░
  349.         ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  350.          Figure 2
  351.         
  352.  
  353.      If you <Accept> the line, the INSTALL.EXE modifies itself so that the line
  354. you just entered appears from then on, each time you run the program, where
  355. the end-user would otherwise see the DataWorks, Inc. copyright information.
  356.  
  357.      Next you will be returned to the DOS environment, at which point you will
  358. have to type INSTALL again if you wanted to run the program to check and see
  359. that your line has been properly inserted.
  360.  
  361.      Now, the next step is to configure Program Installer for a few other
  362. options that really make up the program's strength.
  363.  
  364.      These configuration steps/options can be changed for any/all applications
  365. you may want to use Program Installer with.
  366.      
  367.  
  368.      To configure Program Installer you type
  369.  
  370.         INSTALL LICSETUP <Enter>
  371.  
  372.      The following screen will appear:
  373.  
  374. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  375. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  376. ░░░░░░░░░░░░░░░░░░░░░░░░░░▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀░░░░░░░░░░░░░░░░░░░░░░░░░░
  377. ░░░░░░░░░░░░░░░░░░░░░░░░░█ Program Installer Setup  ░░░░░░░░░░░░░░░░░░░░░░░░░░
  378. ░░░░░░░░░░░░░░░░░░░░░░░░░█        Main Menu         ░░░░░░░░░░░░░░░░░░░░░░░░░░
  379. ░░░░░░░░░░░░░░░░░░░░░░░░░█──────────────────────────░░░░░░░░░░░░░░░░░░░░░░░░░░
  380. ░░░░░░░░░░░░░░░░░░░░░░░░░█                          ░░░░░░░░░░░░░░░░░░░░░░░░░░
  381. ░░░░░░░░░░░░░░░░░░░░░░░░░█     1    Setup Disks     ░░░░░░░░░░░░░░░░░░░░░░░░░░
  382. ░░░░░░░░░░░░░░░░░░░░░░░░░█     2    Exit            ░░░░░░░░░░░░░░░░░░░░░░░░░░
  383. ░░░░░░░░░░░░░░░░░░░░░░░░░█                          ░░░░░░░░░░░░░░░░░░░░░░░░░░
  384. ░░░░░░░░░░░░░░░░░░░░░░░░░█████████████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  385. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  386. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  387. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  388. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  389. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  390.        Copyright (C) 1990..1992 The DataWorks, Inc.   All Rights Reserved.
  391. ------------------------------------------------------------------------------
  392.  Figure #3
  393.  
  394.  
  395.  
  396.  
  397.      From this menu choose option #1 (Setup Disks) and press <Enter>.
  398. The following screen should appear (NOTE: The directories you may see on
  399. the left side of the screen may be different, but the screen layout the
  400. same):
  401.  
  402. ╔═════════════════╣ C:\ ╠══════════════════╗╔═══════════════════  3:39:16 p.m. ╗
  403. ║      Name    │   Size  │  Date  │  Time  ║║ Selected Files for Archiving     ║
  404. ║──────────────────────────────────────────║║──────────────────────────────────║
  405. ║  AM          │SUB-DIR│ 1-18-92│ 1:39p    ║║                                  ║
  406. ║  APRO        │SUB-DIR│12-22-91│10:07a    ║║                                  ║
  407. ║  ART         │SUB-DIR│ 1-15-92│ 2:04p    ║║                                  ║
  408. ║  CHATBOX     │SUB-DIR│12-22-91│ 9:40a    ║║                                  ║
  409. ║  CPUP        │SUB-DIR│12-27-91│ 9:57a    ║║                                  ║
  410. ║  CUP         │SUB-DIR│12-27-91│ 9:57a    ║║                                  ║
  411. ║  DV          │SUB-DIR│12-22-91│ 9:40a    ║║                                  ║
  412. ║  DWORKS      │SUB-DIR│12-22-91│10:09a    ║║                                  ║
  413. ║  EZTAPE      │SUB-DIR│12-22-91│ 9:22a    ║║                                  ║
  414. ║  FAST        │SUB-DIR│12-22-91│10:25a    ║║                                  ║
  415. ║  NEWSWORK    │SUB-DIR│ 1-04-92│ 5:42a    ║║                                  ║
  416. ║  NWLITE      │SUB-DIR│ 1-03-92│ 7:08p    ║║                                  ║
  417. ║  OFFLINE     │SUB-DIR│12-22-91│ 9:40a    ║║                                  ║
  418. ╠══════════════════════════════════════════╝╚══════════════════════════════════╣
  419. ║ Select files or directories to archive                                       ║
  420. ╠══════════════════════════════════════════════════════════════════════════════╣
  421. ║            File Style: Just Compression;  Floppy Disk Size: 360 k            ║
  422. ║                               PI Directory: C:\                              ║
  423. ╠══════════════════════════════════════════════════════════════════════════════╣
  424. ║ <+, -, Space> Mark/Unmark files               <Alt-D> New Drive              ║
  425. ║ <Tab> Archive List      <Alt-S> Options       <F10> Archive       <Esc> Quit ║
  426. ╚══════════════════════════════════════════════════════════════════════════════╝
  427. --------------------------------------------------------------------------------
  428.  Figure #4
  429.  
  430.  
  431.     Before we get involved with this screen, let's configure Program Installer
  432. first, and then we'll come back to this screen.
  433.  
  434.  
  435.     At this time, press <Alt-S> (hold down the Alt key on your keyboard, and
  436. then press the 'S' character). You should see the following screen:
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449. ■ (06/11/92) - See note at end of this document. We have included an
  450.                additional line with AUTOEXEC/CONFIG modifications that
  451.                you can flag indicating you want PI to run a CLEANUP.BAT
  452.                file at the end of your installation.
  453.  
  454. ╔═══════════════════════ Program Installer Preferences ════════════════════════╗
  455. ║                                                                              ║
  456. ║ ╔═════════ Archive File Options ══════════╗  ┌── Maximum Disk Size ───┐      ║
  457. ║ ║ ( )   Just Encryption                   ║  │ ( )   360 k            │      ║
  458. ║ ║ (*)   Just Compression                  ║  │ ( )   720 k            │      ║
  459. ║ ║ ( )   Both Encryption and Compression   ║  │ (*)   1.2 meg          │      ║
  460. ║ ║                                         ║  │ ( )   1.4 meg          │      ║
  461. ║ ╚═════════════════════════════════════════╝  └────────────────────────┘      ║
  462. ║                                                                              ║
  463. ║ ┌────────────────── Autoexec.bat and Congig.sys Options ───────────────────┐ ║
  464. ║ │ [X]  Update AUTOEXEC.BAT with user defined information?                  │ ║
  465. ║ │ [ ]  Update CONFIG.SYS with user defined information?                    │ ║
  466. ║ └──────────────────────────────────────────────────────────────────────────┘ ║
  467. ║   Allowed installations (1 to 255; Enter 0 for unlimited): 0··               ║
  468. ║                                                                              ║
  469. ║ ┌─────────────────────────── AUTOEXEC.BAT info. ───────────────────────────┐ ║
  470. ║ │ path %PATH%;Mypat······················································· │ ║
  471. ║ │ ········································································ │ ║
  472. ║ │ ········································································ │ ║
  473. ║ ├──────────────────────────── CONFIG.SYS Info. ────────────────────────────┤ ║
  474. ║ │ ········································································ │ ║
  475. ║ │ ········································································ │ ║
  476. ║ │ ········································································ │ ║
  477. ║ └──────────────────────────────────────────────────────────────────────────┘ ║
  478.  <Ctrl-Enter> Save Setup   <Tab, Enter, Shift-Tab> Change fields   <Esc> Cancel
  479.  -------------------------------------------------------------------------------
  480.   Figure #5
  481.  
  482.  
  483.      This is where the real configuration is done for your application's
  484. distribution. In the 'Archive File Options' box (upper left box in the screen),
  485. you'll notice that the default is 'Just Compression'. Most users of Program
  486. Installer don't really need the 'Encryption' feature, and just use the
  487. 'Compression' feature when setting up their disks.
  488.  
  489.      'Just Encryption' - If you choose this option then the files that
  490. Program Installer prepares for your distribution diskettes will not be
  491. compressed. This will require more floppies for your software/application.
  492. However, it will still protect your interests some, because the INSTALL
  493. program will be the only way these prepared DISK1.X, DISK2.X, etc. (for how-
  494. ever many disks are required for your application) files cannot be unpacked
  495. (not uncompressed - like DOS's BACKUP program, INSTALL determines how many
  496. of the files selected, when grouped, best fit on each floppy, depending on the
  497. size of the floppy disk you are using. It creates one DISKx file for each
  498. disk, and each of these DISKx files contains files that make up your
  499. application. So, though your files are not compressed, they are still
  500. packed, or "combined" into one file for each distribution diskette) and
  501. copied onto the end-user's hard drive without using INSTALL to do so. To
  502. further protect your interests, the packed ("combined") file is also
  503. encrypted so even if the best of hackers could figure out how to unpack our
  504. formats, they would first have to figure out how to decrypt the file!
  505.  
  506.  
  507.  
  508.  
  509.      You would choose 'Just Encryption' if you did not want to use compression
  510. on your files, and if you wanted to speed up the process of preparing your
  511. disk(s) for distribution.
  512.  
  513.      'Just Compression' - The default mode, using 'Just Compression', the
  514. INSTALL program goes through all of the files within a given directory that
  515. you have selected for use in your application and compresses each file. This
  516. is done before the packing of the DISKx files that will be placed on each
  517. distribution diskette.
  518.  
  519.      We use the .LZH compression technique from TurboPower Software's
  520. Async Professional <tm> toolkit. This technique is as good as most any other
  521. on the market today. However, it is not as fast as others (like PkZip <tm>).
  522. Depending on the number and size of the files you have selected for your
  523. application (we'll get into how to do this when we return to working with
  524. the screen in Figure #5), this could take some time. On one beta site, we
  525. selected a subdirectory with over 436 files in it, totalling some 8.7
  526. megabytes in uncompressed form. It took just over 30 minutes for Program
  527. Installer to complete the compression of all the files, and prepare the four
  528. DISKx files. We elected to use Encryption and Compression for this test,
  529. really putting the program through its paces. It performed quite well.
  530. Although, it took this long to create the DISKx files for distribution,
  531. when installing your application, Program Installer takes only minutes,
  532. depending on the speed of the end-user's hard drive. The installation
  533. and extraction of the DISKx files takes only a few minutes compared to the
  534. time it takes the program to create these files initially. We really
  535. cannot explain in simple terms why this is so.
  536.  
  537.      'Both Encryption and Compression' - Select this option to encrypt the
  538. compressed DISKx files you are setting up for distribution. Here again,
  539. the encryption is just an added feature/measure to help protect your
  540. interests.
  541.  
  542.      Once you have selected which of these three features to use, press
  543. the <TAB> key on your keyboard and you will jump to the 'Maximum Disk Size'
  544. window. Notice that the boarder around the window you are in is a double-line
  545. boarder, and the other windows have single-line boarders around them. This
  546. is one way you can quickly determine which window you are currently in.
  547.  
  548.      Here, using the <Up> or <Down> cursor keys again, you
  549. specify which size floppy diskette you are using for your distribution
  550. disks. The only thing Program Installer won't take care of for you, is
  551. the formatting of these floppy diskettes. You must make sure, that when
  552. Program Installer prompts you for a floppy disk, no matter which size you
  553. elect to use, the floppy must be formatted before Program Installer can
  554. place any files on it. And the floppy must be complete blank, with not even
  555. the system boot files on it (except for the very first - INSTALL - diskette).
  556.  
  557.      Next, press the <TAB> key again, and you will go to the 'Autoexec.bat
  558. and Config.sys Options' window. Here you can specify 1, 2, or all 3 of 3
  559. available options.
  560.  
  561.  
  562.  ■■■ NOTICE - SEE UPDATE INFO ON THIS AT THE END OF THIS DOC ■■■
  563.  
  564.      'Update AUTOEXEC.BAT with installation path?' - If you press the
  565. <Space-Bar> while the cursor is on this option, you will see an 'X' appear
  566. between the brackets. This options tells Program Installer to update the end-
  567. user's AUTOEXEC.BAT file PATH command line with the path (complete drive,
  568. subdirectory name, etc.) that the user specified for installing your
  569. application (later in this document, we'll cover that actual installation
  570. procedure that the end-user performs and how it operates). This is specified
  571. at the time the user installs (runs INSTALL) your application. Leave this
  572. option blank (default) if you do NOT want the installed subdirectory of your
  573. application's path included in the end-user's system's PATH statement.
  574.  
  575.      'Update AUTOEXEC.BAT with SET= 'VARIABLES'?' - This option is provided
  576. for developers of applications like those done with CLIPPER. Here, the
  577. end-user would have to update their own AUTOEXEC.BAT file with a
  578.  
  579.         SET variablename = \APPLICATION DIRECTORY
  580.  
  581. for CLIPPER to properly find itself during runtime. Other applications may
  582. use environment variables as well, and may need environment SET variables
  583. added to the AUTOEXEC.BAT file. Program Installer allows you to define up to
  584. three (3) such variables (see the '"Set" Variables' window, next).
  585.  
  586.      'Update CONFIG.SYS with user defined information?' - Like the SET= VARIABLES
  587. option, this option will allow you to define up to three (3) lines of
  588. information that will be appended to the end-user's CONFIG.SYS file. Like with
  589. the SET= VARIABLES option, this may be necessary for some applications. Quite
  590. often, many DOS installation programs and other applications do not set
  591. parameters in a CONFIG.SYS file like the FCBS= or the STACKS= parameters.
  592. However, your application may need these set a specific way. You can define
  593. the line, exactly as it must appear, and up to three (3) of these lines,
  594. in the 'CONFIG.SYS Info' window.
  595.  
  596.      Press <TAB> again and the cursor goes to the 'Allowed installations
  597. (1 to 255; Enter 0 for unlimited):' field. This is provided as an added measure,
  598. again, to help protect your interests. You can set this to say, 2, and then
  599. INSTALL will only allow itself to be run twice for this configuration. Now,
  600. if the user begins the INSTALL process and aborts, that doesn't count. Only
  601. if they complete a successful installation will it count. So, if you only
  602. want your application to be able to be installed once or twice, set this to
  603. 1 or 2, respectively. Of course, this doesn't stop them from making disk copies
  604. of your application initially, but it is a deterent!
  605.  
  606.  
  607.      Program Installer keeps a log of everything it does for your given
  608. configurations. It creates a directory called #_PI.DIR, in the directory/
  609. path you specify (or off of the root of C:\ as it defaults for) and in this
  610. directory it maintains its log file, and also uses this directory to build
  611. or compress the disk files that are to be prepared for your distribution
  612. disks. So, if you just leave the default, or change it to a drive letter
  613.  
  614.  
  615.  
  616. of your choice, but don't specify a subdirectory, just a root directory,
  617. you will find the #_PI.DIR subdirectory created off of the root directory
  618. after you have completed setting up a set of distribution diskettes. In
  619. this subdirectory you will also find a PI_x.LOG file, where x is the
  620. number of the log. Program Installer looks for the existence of a log file
  621. in its work directory before beginning. If, for example, you run Program
  622. Installer for the first time, it creates the PI_0.LOG file in the work
  623. directory (#_PI.DIR in this case). Now, if you don't delete the log file/
  624. work directory, the next time you run Program Installer, if you use the
  625. same work directory, it will see the PI_0.LOG file, and name the next one
  626. PI_1.LOG, and so on.
  627.  
  628.      Pressing <TAB> from here, you go to the '"Set" Variables' window. Here
  629. is where you can define environment variables that you want inserted into the
  630. end-user's AUTOEXEC.BAT file. NOTE: In this window you type only the name
  631. of the environment variable, and nothing else. Program Installer knows how
  632. to handle the rest of the syntax. For example, if you need the line
  633.  
  634.                 SET MYPATH=directoryname/path
  635.  
  636. all you need to type here is 'MYPATH' in this window. Program Installer will
  637. set it equal to the subdirectory that your application gets installed into.
  638. This is determined by the INSTALL program at runtime, when the end-user is
  639. actually installing your application. So, if you need this to be a GIVEN sub-
  640. directory, be sure to include the subdirectory name in your documentation to
  641. the end-user.
  642.  
  643.      NOTE: Any variable you need defined will only be set to the installation path
  644. and this is hard coded for now. We're working on incorporating a more flexible
  645. option that'll allow you to actually type in the complete SET= statement
  646. yourself, hence allowing you to point to perhaps your own TEMP subdirectory,
  647. or some other work directory, other than the primary installation sub-
  648. directory. This feature should be available in one of the minor 4.x updates
  649. that'll be posted in the next month or two.
  650.  
  651.      Press <TAB> once more and you'll move to the 'CONFIG.SYS Info' window.
  652. Here you can add up to three (3) additional lines for parameter definitions
  653. in the end-user's CONFIG.SYS file. Something like
  654.  
  655.         FCBS=16,32
  656.  
  657. or
  658.  
  659.         STACKS=0,0
  660.  
  661. or whatever you may need to be sure has been set in the CONFIG.SYS. NOTE: If
  662. you do define something here that may already be defined in the end-user's
  663. CONFIG.SYS file, Program Installer will detect this, and then determine if
  664. the end-user's system is configured equal to, or greater than your specks.
  665. This applies to things like FILES= or BUFFERS=. If you type these into this
  666. window now as, for example, FILES=30 and BUFFERS=25 (on two separate lines in
  667. this window, of course), then Program Installer will first check to see if
  668.  
  669.  
  670.  
  671. these parameters are not already defined in the CONFIG.SYS. If they are not,
  672. your lines will be inserted. If these two parameters are already defined,
  673. however, the values of your lines will be compared with the values already
  674. in the CONFIG.SYS file. If yours are greater, in this case, your lines
  675. will be written into the file, and theirs will be removed.
  676.  
  677.      A case that the greater does NOT replace what is already in the
  678. CONFIG.SYS file is with the STACKS= parameter. If you define this
  679. parameter in this window, and if it already exists in the end-user's
  680. CONFIG.SYS file, then yours will be written to the file anyway! Also,
  681. if you enter the SHELL= statement in this window, Program Installer WILL
  682. compare the environment space indicated with the /E: /P switches, and if
  683. you are allocating more space than may already be allocated, then your
  684. line will replace whatever may already be in the CONFIG.SYS file.
  685. If there is not a SHELL= statement in the CONFIG.SYS file, then of
  686. course, your line will be inserted. However, if you are, for example,
  687. allocating 256K of environment space, when there is already 512K of
  688. environment space allocated, then your line will be ignored.
  689.  
  690.      There are a lot of caveats, we know, that we will try and
  691. enhance/dress-up as we gradually update the program. For now, we
  692. hope these configuration options are adequate.
  693.  
  694.      Once you have set all of your options in this screen, you can save
  695. this setup by pressing <Ctrl-Enter> (hold down the CONTROL/Ctrl key and
  696. pressing ENTER). If you need to edit your setup, use the <TAB> key to
  697. navigate the screen and make any necessary changes. To abort altogether
  698. you can press <Esc> to abort.
  699.  
  700.      Once you save your options, you are returned to the work screen,
  701. as previously shown in Figure #5. You should see a screen similar to the
  702. following:
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726. ╔═════════════════╣ C:\ ╠══════════════════╗╔═══════════════════ 1:01:34 a.m. ═╗
  727. ║      Name    │   Size  │  Date  │  Time  ║║ Selected Files for Archiving     ║
  728. ║──────────────────────────────────────────║║──────────────────────────────────║
  729. ║  AM          │SUB-DIR│ 1-18-92│ 1:39p    ║║                                  ║
  730. ║  APRO        │SUB-DIR│12-22-91│10:07a    ║║                                  ║
  731. ║  ART         │SUB-DIR│ 1-15-92│ 2:04p    ║║                                  ║
  732. ║  CHATBOX     │SUB-DIR│12-22-91│ 9:40a    ║║                                  ║
  733. ║  CPUP        │SUB-DIR│12-27-91│ 9:57a    ║║                                  ║
  734. ║  CUP         │SUB-DIR│12-27-91│ 9:57a    ║║                                  ║
  735. ║  DV          │SUB-DIR│12-22-91│ 9:40a    ║║                                  ║
  736. ║  DWORKS      │SUB-DIR│12-22-91│10:09a    ║║                                  ║
  737. ║  EZTAPE      │SUB-DIR│12-22-91│ 9:22a    ║║                                  ║
  738. ║  FAST        │SUB-DIR│12-22-91│10:25a    ║║                                  ║
  739. ║  NEWSWORK    │SUB-DIR│ 1-04-92│ 5:42a    ║║                                  ║
  740. ║  NWLITE      │SUB-DIR│ 1-03-92│ 7:08p    ║║                                  ║
  741. ║  OFFLINE     │SUB-DIR│12-22-91│ 9:40a    ║║                                  ║
  742. ╠══════════════════════════════════════════╝╚══════════════════════════════════╣
  743. ║ Select files or directories to archive                                       ║
  744. ╠══════════════════════════════════════════════════════════════════════════════╣
  745. ║    File Style: Both Encryption and Compression; Floppy Disk Size: 1.2 meg    ║
  746. ║                               PI Directory: C:\                              ║
  747. ╠══════════════════════════════════════════════════════════════════════════════╣
  748. ║ <+, -, Space> Mark/Unmark files               <Alt-D> New Drive              ║
  749. ║ <Tab> Archive List      <Alt-S> Options       <F10> Archive       <Esc> Quit ║
  750. ╚══════════════════════════════════════════════════════════════════════════════╝
  751. --------------------------------------------------------------------------------
  752.  Figure #6
  753.  
  754.  
  755.      From this work screen we will instruct Program Installer as to the files
  756. that make up your entire application. What we've done here is pretty straight
  757. forward. However, before we get into using this screen to build the
  758. distribution diskettes, let's briefly go over the menu options at the bottom
  759. of the screen in Figure #6.
  760.  
  761.      <+, -, Space> Means that you can use the PLUS and MINUS keys on your
  762. ten-key key pad (this is on the right side of the keyboard on 101 or newer
  763. enhanced keyboards) to mark or unmark individual files for packing. If you
  764. do not have an enhanced keyboard, with the ten-key keypad on the right side,
  765. you can use the <Space-Bar> if/when you need to flag a specific group of files,
  766. flagging each one individually.
  767.  
  768.      The <Space-Bar> is better suited for flagging an entire subdirectory
  769. for packing. Let's say all of your application resides in one subdirectory.
  770. Just scroll to that subdirectory and press the <Space-Bar>. You'll see a
  771. √ check mark appear to the left of the directory name, and the specifications
  772. for that flagged directory appear on the right side of the work screen. This
  773. shows what is selected for Program Installer to either compress/encrypt or both
  774. for your distribution diskettes.
  775.  
  776.      The <+> and <-> keys are better suited for selecting a group of files that
  777. reside in a common directory, with say, the same file extension, or something
  778.  
  779.  
  780.  
  781. similar to each file name. For example, if my application is a database system,
  782. and all of the database files must be initialized (already exist) for the
  783. main program to work, then I may want to initialize them now, then select
  784. just the .DBF and .NDX files for packing. If all of these files reside in a
  785. subdirectory where other files reside with a different suffix, I can use the
  786. <+> key to flag just these files.
  787.  
  788.      When you press either the <+> or <-> keys (on the key-pad now!), you
  789. will see a small box appear in the center of the work screen. In the box
  790. the prompt is defaulted for the DOS wildcard '*.*'. Here I could change
  791. this to *.DBF first, then press <Enter>. Then press the <+> key again
  792. and change it to *.NDX. This would select my group of files out of the
  793. many files that could also be residing in the same subdirectory.
  794.  
  795.      Pressing the <+> key prompts you for files/wildcard combinations to
  796. select for packing, and the <-> key prompts you for files to deselect
  797. from your setup work screen.
  798.  
  799.      Likewise, if you have pressed the <Space-Bar> while on a subdirectory
  800. name and have selected it for packing, pressing the <Space-Bar> on that
  801. same subdirectory name again, will deselect all those files for packing.
  802.  
  803.      Let's walk through a cenario here, pretending to build a set of
  804. distribution disks for our product. To make this easy though, lets go
  805. further and pretend that the DOS subdirectory on your hard drive is the
  806. application's installed subdirectory.
  807.  
  808.      If this were the case, simply make sure that all of the files necessary
  809. to the application are installed in this subdirectory. (Mine is called
  810. \PUBLIC\V5.00, but yours may be \DOS or any other name - Just use whatever
  811. subdirectory your DOS system files are installed in.)
  812.  
  813.      In my case, my DOS system files are in a subdirectory that is nested off
  814. of my root directory. To navigate through subdirectories with the work screen,
  815. use the <Up> and <Down> cursor keys to move your cursor, then press <Enter>
  816. when on a subdirectory name that you would like to enter. When you ARE
  817. in a subdirectory, you will see the drive and path that you are in in the
  818. center of the top-left column of the work screen. Also, you will notice that
  819. the very top/first entry in the subdirectory is now not a subdirectory or
  820. file name, but two (2) dots '..' instead. This indicates that you ARE in a
  821. subdirectory, and to get out of the subdirectory, you place the cursor on
  822. these two dots and press enter. This will take you back to the previous
  823. path level. If you were nested down several subdirectories, you would
  824. simply repeat this for each level, until you back all the way out to the
  825. root directory.
  826.  
  827.      Once inside my \PUBLIC subdirectory, I press the <Space-Bar> when the
  828. cursor is on my V5.00 subdirectory. The screen looks like the following:
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836. ╔══════════════╣ C:\PUBLIC\ ╠══════════════╗╔═══════════════════ 1:54:30 a.m. ═╗
  837. ║      Name    │   Size  │  Date  │  Time  ║║ Selected Files for Archiving     ║
  838. ║──────────────────────────────────────────║║──────────────────────────────────║
  839. ║  ..          │ UP--DIR │12-22-91│ 9:25a  ║║C:\PUBLIC\V5.00\*.*               ║
  840. ║  DOSU        │ SUB-DIR │12-22-91│ 9:25a  ║║                                  ║
  841. ║√ V5.00       │ SUB-DIR │12-22-91│ 9:26a  ║║                                  ║
  842. ║  bw       exe│   117456│ 7-29-91│ 1:52p  ║║                                  ║
  843. ║  bwback   ovr│    39598│ 7-29-91│ 1:52p  ║║                                  ║
  844. ║              │         │        │        ║║                                  ║
  845. ║              │         │        │        ║║                                  ║
  846. ║              │         │        │        ║║                                  ║
  847. ║              │         │        │        ║║                                  ║
  848. ║              │         │        │        ║║                                  ║
  849. ║              │         │        │        ║║                                  ║
  850. ║              │         │        │        ║║                                  ║
  851. ║              │         │        │        ║║                                  ║
  852. ╠══════════════════════════════════════════╝╚══════════════════════════════════╣
  853. ║ Select files or directories to archive                                       ║
  854. ╠══════════════════════════════════════════════════════════════════════════════╣
  855. ║    File Style: Both Encryption and Compression; Floppy Disk Size: 1.2 meg    ║
  856. ║                               PI Directory: C:\                              ║
  857. ╠══════════════════════════════════════════════════════════════════════════════╣
  858. ║ <+, -, Space> Mark/Unmark files               <Alt-D> New Drive              ║
  859. ║ <Tab> Archive List      <Alt-S> Options       <F10> Archive       <Esc> Quit ║
  860. ╚══════════════════════════════════════════════════════════════════════════════╝
  861. --------------------------------------------------------------------------------
  862.  Figure #7
  863.  
  864.  
  865.      By pressing the <Space-Bar> while on a subdirectories's name, you are
  866. instructing Program Installer to flag ALL of the files in that subdirectory
  867. for packing. That is why you see the \PUBLIC\V5.00\*.* setting in the right
  868. column of the work screen in Figure #7 above. Now, if this were all I needed
  869. to install my application, I could press the <F10> key now, and Program
  870. Installer will begin its work, prompting me as needed for blank floppies, or
  871. to press any key to continue, as it worked to build the distribution disks
  872. for my application. However, let's make it more difficult. Let's say I don't
  873. want ANY of the .COM files out of this directory included in the packing! At
  874. this point I would press <Enter> while my cursor was on the V5.00 subdirectory,
  875. then press the <-> key and replace the default wildcard with *.COM, and press
  876. <Enter>. The screen looks like the following:
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891. ╔═══════════╣ C:\PUBLIC\V5.00\ ╠═══════════╗╔═══════════════════ 2:04:32 a.m. ═╗
  892. ║      Name    │   Size  │  Date  │  Time  ║║ Selected Files for Archiving     ║
  893. ║──────────────────────────────────────────║║──────────────────────────────────║
  894. ║  ..          │ UP--DIR │12-22-91│ 9:26a  ║║C:\PUBLIC\V5.00\*.BAS             ║
  895. ║√ gorilla  bas│    29434│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.CPI             ║
  896. ║√ money    bas│    46225│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.EXE             ║
  897. ║√ nibbles  bas│    24103│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.GRB             ║
  898. ║√ remline  bas│    12314│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.HLP             ║
  899. ║  assign   com│     6399│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.INI             ║
  900. ║  command  com│    47845│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.LST             ║
  901. ║  diskcomp com│    10652│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.PRO             ║
  902. ║  diskcopy com│    11793│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.SYS             ║
  903. ║  doskey   com│     5883│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.TXT             ║
  904. ║  dosshell com│     4623│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.VID             ║
  905. ║  edit     com│      413│ 4-09-91│ 5:00a  ║║                                  ║
  906. ║  format   com│    32911│ 4-09-91│ 5:00a  ║║                                  ║
  907. ╠══════════════════════════════════════════╝╚══════════════════════════════════╣
  908. ║ Select files or directories to archive                                       ║
  909. ╠══════════════════════════════════════════════════════════════════════════════╣
  910. ║    File Style: Both Encryption and Compression; Floppy Disk Size: 1.2 meg    ║
  911. ║                               PI Directory: C:\                              ║
  912. ╠══════════════════════════════════════════════════════════════════════════════╣
  913. ║ <+, -, Space> Mark/Unmark files               <Alt-D> New Drive              ║
  914. ║ <Tab> Archive List      <Alt-S> Options       <F10> Archive       <Esc> Quit ║
  915. ╚══════════════════════════════════════════════════════════════════════════════╝
  916. --------------------------------------------------------------------------------
  917.  Figure #8
  918.  
  919.  
  920.      As you can see, the .COM files have now been deselected (the √ check
  921. mark removed from the left of the filename), and on the right side you now
  922. see a more descritive listing showing what we are going to pack. These
  923. as WE know, are all of the files, except those that end in .COM, out of my
  924. \PUBLIC\V5.00 subdirectory.
  925.  
  926.      Now, to begin the process that will build my distribution diskettes, I
  927. simply press the <F10> key.
  928.  
  929.      What follows, after you press the <F10> key is the compression part, if
  930. you chose to use 'Compression' in your setup. After the compression is done,
  931. Program Installer begins the packing process, packing a number of files into
  932. one (1) or more DISKx files. I have chosen Compression and Encryption in my
  933. setup and now Program Installer is 'Freezing' all of my files. This is the
  934. term used in LZH that tells you the file is being compressed. Once this is
  935. done I see a listing of file names scroll by as Program Installer is packing
  936. as many of the compressed files into DISK1.LZX. If not all of the files will
  937. fit on one (1) 1.2 megabyte 5 1/4" floppy, Program Installer goes on to
  938. packing the DISK2.LZX file for my System Disk 2 (distribution diskette).
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.      Once all of the compressing and packing is done, I then see the
  947. DISK1 and DISK2.LZX files being encrypted. After this, I am instructed that
  948. my setup will need three completely blank foppy diskettes. The first floppy is
  949. the INSTALL program. Also, if I have any README.DOC or other such files,
  950. Program Installer will install them from this first INSTALL diskette for me
  951. when the end-user runs INSTALL. The next two floppies are the DISK1.LZX and
  952. DISK2.LZX.
  953.  
  954.      The .LZX is Program Installer's way of knowing that this is not only
  955. a compressed, but also an encrypted diskette. We use three types of
  956. file suffix names (extensions):
  957.  
  958.         .X      This extension is used for 'Encryption Only'.
  959.         .LZH    This extension is used for 'Compression Only'.
  960.         .LZX    This extension is used for 'Encryption & Compression'.
  961.  
  962.      These file extensions are added to the DISKx file for each distribution
  963. floppy diskette. The actual files that you select for distribution have
  964. nothing to do with our own file extensions.
  965.  
  966.      Finally, one additional option in the Options Menu of the work screen
  967. in Figure #8 is <Alt-D>. Pressing <Alt-D> allows you to select a different
  968. hard drive to work with for selecting (tagging) files for packing for your
  969. distribution diskettes.
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.                  WRAPPING UP THE CONFIGURATION OPTIONS
  1003.  
  1004.  
  1005.      That just about covers it from start to finish, insofar as the
  1006. configuration options are concerned.
  1007.  
  1008.      You will want to work with the configuration options to become
  1009. even more familiar with Program Installer's nice, built-in, setup screens.
  1010. After you have configured and distributed a couple of products, you will
  1011. find Program Installer quite easy and fast to work with.
  1012.  
  1013.      If you need any help at all, we offer various levels of technical
  1014. support. Next we're going to briefly cover the actual INSTALL program
  1015. from the end-user's standpoint.
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.                       INSTALLING YOUR APPLICATION
  1057.                        The End-User's Perspective
  1058.  
  1059.      The following documentation is provide to help you, the Developer, or
  1060. Distributor with some ideas on how to document your own manual, insofar as
  1061. covering the installation procedure. You are free to reproduce or use any of
  1062. the following, in any form or fashion, in any/all of your own documentation
  1063. for your own applications.
  1064.  
  1065.  
  1066.                               INSTALLATION
  1067.  
  1068.      To install your application, simply place the INSTALL system diskette
  1069. in either the 'A' or 'B' drive. Next, change to that drive and type INSTALL.
  1070.  
  1071.      This example will assume that you are using the 'A' drive, but if you
  1072. are using the 'B' drive, simply replace any reference to 'A' in the following,
  1073. with 'B'.
  1074.  
  1075.      To change to the 'A' drive, from the DOS prompt you type
  1076.  
  1077.         A: <Enter> - <Enter> means to press the enter / return key
  1078.                       on your keyboard.
  1079.  
  1080. Then type INSTALL and press <Enter> again. You should see the following screen:
  1081.  
  1082.  
  1083.  
  1084. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1085. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1086. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1087. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1088. ░░░░░░░░░░░░░░░░▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀░░░░░░░░░░░░░░░░░
  1089. ░░░░░░░░░░░░░░░█    Program Installer - Main Menu    ░░░░░░░░░░░░░░░░░
  1090. ░░░░░░░░░░░░░░░█─────────────────────────────────────░░░░░░░░░░░░░░░░░
  1091. ░░░░░░░░░░░░░░░█                                     ░░░░░░░░░░░░░░░░░
  1092. ░░░░░░░░░░░░░░░█     1    Install Program Disk(s)    ░░░░░░░░░░░░░░░░░
  1093. ░░░░░░░░░░░░░░░█     2    Exit Install Program       ░░░░░░░░░░░░░░░░░
  1094. ░░░░░░░░░░░░░░░█                                     ░░░░░░░░░░░░░░░░░
  1095. ░░░░░░░░░░░░░░░████████████████████████████████████░░░░░░░░░░░░░░░░░░░
  1096. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1097. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1098. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1099. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1100. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1101. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1102.   Copyright (C) 1990..1992 The DataWorks, Inc.   All Rights Reserved.
  1103. ______________________________________________________________________
  1104.  Figure #9
  1105.  
  1106.      At this point you want to choose option 1) Install Program Disk(s).
  1107. This will bring up the next screen, where you will be prompted to enter the
  1108. source drive you are using. The source drive is the floppy drive that you
  1109. inserted the INSTALL diskette in.
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115. ░░░░░░░░░░░░░░░░░┌───────────────────────────────────────────┐░░░░░░░░░░░░░░░░░░
  1116. ░░░░░░░░░░░░░░░░░│      Program Installer Version 4.5        │░░░░░░░░░░░░░░░░░░
  1117. ░░░░░░░░░░░░░░░░░└───────────────────────────────────────────┘░░░░░░░░░░░░░░░░░░
  1118. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1119. ░░┌─────────────────────────────────────────────────────────────────────────┐░░░
  1120. ░░│    Copyright (C) 1990..1992 The DataWorks, Inc.   All Rights Reserved.  │░░░
  1121. ░░└─────────────────────────────────────────────────────────────────────────┘░░░
  1122. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1123. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1124. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1125. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1126. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1127. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1128. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1129. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1130. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1131. ░░░░░░░░░░╔════════════════════════════════════════════════════╗░░░░░░░░░░░░░░░░
  1132. ░░░░░░░░░░║ Enter the SOURCE drive to use:  A                  ║░░░░░░░░░░░░░░░░
  1133. ░░░░░░░░░░╚════════════════════════════════════════════════════╝░░░░░░░░░░░░░░░░
  1134. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1135. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1136. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1137. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1138. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1139. [Enter] - Select    [Esc] - Quit                                             
  1140. ________________________________________________________________________________
  1141.  Figure #10
  1142.  
  1143.  
  1144.      Here you can either press <Enter> to accept the default drive, or enter B
  1145. to replace the default of A, and then press <Enter>.
  1146.  
  1147.      Next you will see the same screen, except you are being prompted to enter
  1148. the destination directory to install the application into. Program Installer
  1149. already has a default directory built in, and you can just press <Enter> to
  1150. accept the default of 'C:\', or replace the C:\ with the proper drive letter
  1151. of your choosing.
  1152.  
  1153.                      NOTE TO DEVELOPER/DISTRIBUTOR
  1154.  
  1155.      When you configure Program Installer, and then from the work screen,
  1156. select the subdirectory(s) to pack your program disk(s) from, Program Installer
  1157. retains that subdirectory(s) name and will install back into that same
  1158. directory(s) on the end-user's system. This is important to note, as you
  1159. need to be sure that you have your application set up exactly as it will need
  1160. to be on the end-user's system when it installs. Hence the end-user really
  1161. only needs to press <Enter> at the default prompt of C:\ for the destination
  1162. directory to install into, unless they are installing onto a different
  1163. hard drive.
  1164.  
  1165.     If you need to, feel free to call our technical support for more information
  1166. on how Program Installer works in this regard.
  1167.                   END OF NOTE TO DEVELOPER/DISTRIBUTOR
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.            SPECIAL NOTE ON AUTOEXEC.BAT and CONFIG.SYS FILES
  1174.  
  1175.  
  1176.      The install program may need to modify some variables in your AUTOEXEC.BAT
  1177. file, and parameters in your CONFIG.SYS file.
  1178.  
  1179.      Depending on your application, INSTALL may need to add this program's
  1180. subdirectory to your PATH statement, may need to SET variable names for your
  1181. DOS environment so it can find itself or work space it may need, and it may
  1182. need to check and/or add parameters like FILES= and/or BUFFERS= statements
  1183. to your CONFIG.SYS file. However, you will want to check these files after
  1184. INSTALL has completed installation, and be sure INSTALL placed the following,
  1185. or verified that the following already exists in these two files.
  1186.  
  1187.         for AUTOEXEC.BAT
  1188.                         SET=
  1189.                         SET=
  1190.                         SET=
  1191.                         PATH=
  1192.  
  1193.         for CONFIG.SYS
  1194.                         FILES=
  1195.                         BUFFERS=
  1196.                         STACK=
  1197.                         FCBS=
  1198.  
  1199.                     NOTE TO DEVELOPERS/DISTRIBUTORS
  1200.  
  1201.      The above is simply provided to help you with your documentation. Only
  1202. YOU know how your application should be installed, and what parameters/variables
  1203. may need to be set in the AUTOEXEC.BAT or CONFIG.SYS files. I've provided this
  1204. brief documentation for you to give you some ideas on how to conclude the
  1205. installation part of your application's documentation. What you actually place
  1206. here, if anything, depends entirely on your needs, and configuration.
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.                               WRAPPING UP
  1232.  
  1233.  
  1234.      At this point, we at DataWorks hope that this documentation is enough
  1235. for you to not only use Program Installer for your application, but to use
  1236. it to its fullest extents for all of your applications, however many you
  1237. may have. Also, we hope we have provided enough information concerning the
  1238. installation process so that you can easily and quickly write up the installation
  1239. documentation part of your manual/documentation for your application.
  1240.  
  1241.      The DataWorks, Inc. is a software development corporation. We are NOT a
  1242. software distribution company in the commercial sense. We do a lot of 3rd
  1243. party development, but on a much larger scale than this. We are not technical
  1244. writers (those who write the fancy user's manuals, etc.). We simply know how
  1245. to produce professional, high-quality software. At the same time, though, some
  1246. of us get the opportunity to produce a small, simple application like
  1247. Program Installer, and we hope you like it - in spite of how brief this
  1248. manual may be!
  1249.  
  1250.      And remember, Technical Support is only a phone call away, or a message
  1251. away on our Tech Support BBS (DataWorks BBS!), or CompuServe.
  1252.  
  1253.  
  1254.  
  1255. 03/92
  1256.  
  1257.         We also fixed the problem that occurred when you declared say,
  1258. FILES=60 to be inserted into the CONFIG.SYS file. Program Installer 4.5
  1259. DOES properly determine if anything you are wanting to insert into the
  1260. CONFIG.SYS file is going to degrade the current configuration of the
  1261. CONFIG.SYS file, and if so, it won't insert your declarations.
  1262.  
  1263.  
  1264.  
  1265. 04/92
  1266.  
  1267.         With the official release of Program Installer 4.5 there are
  1268. several subtle changes to the setup screens.
  1269.  
  1270. FEATURES
  1271.  
  1272.         With version 4.5 you can now create and compress an application
  1273. that you only need one diskette for, and Program Installer will attempt
  1274. to place this application on the first diskette, if it will fit. If the
  1275. application will not fit, Program Installer will place as much of the
  1276. application on the first disk as possible and then prompt for however
  1277. many disks are needed from that point on.
  1278.  
  1279.         Program Installer now allows you, the programmer, to also type
  1280. in full/complete lines that will be inserted into or appended into the
  1281. end-user's AUTOEXEC.BAT file. Previously you could only declare SET
  1282. variables to be inserted into the AUTOEXEC.BAT file.
  1283.  
  1284.      *** IMPORTANT ***       *** IMPORTANT ***       *** IMPORTANT ***
  1285.  
  1286.  
  1287.         Up to version 4.0, when the end-user was running INSTALL,
  1288. Program Installer, during the installation process, prompted the user
  1289. for the destination directory. With this release, Program Installer
  1290. assumes that the directory structure you built your installation
  1291. diskettes from is the same that you want to install to. If not, then you
  1292. will need to reconfigure, place all of the distribution files in the
  1293. directory structure the way you want the final product to turn out after
  1294. installation, and then re-build your distribution diskette(s).
  1295.  
  1296.  
  1297.  
  1298. 05/92
  1299.         Version 4.6 update. Added the CLEANUP.BAT file feature.
  1300.  
  1301.  
  1302. CLEANUP.BAT
  1303.  
  1304.         Please read carefully...
  1305.  
  1306.         We implemented this feature for distributors that needed a
  1307. little more from Program Installer. For example: One distributor has a
  1308. POS system that requires the MENU.EXE file that drives each network copy
  1309. of the system, reside in its own subdir. Well, before v4.7, this
  1310. distributor actually had to build his distribution diskettes with the
  1311. same copy of the MENU program in various directories, already! This
  1312. means that his actual distribution diskettes turned out quite larger
  1313. (more diskettes) than necessary.
  1314.  
  1315.         Now, with this option, this distributor can create a CLEANUP.BAT
  1316. file, and in that file put the commands that will be necessary to COPY
  1317. the actual MENU program from one original subdirector, to various other
  1318. subdirectories.
  1319.  
  1320.         Other uses of the CLEANUP.BAT file could be:
  1321.  
  1322.         The display of features of your program, once installation is
  1323. complete. For example, if you wanted to display to the user newer
  1324. enhancements to your application that may not be in the manual, you
  1325. could create a CLEANUP.BAT file (though it is a little crude for this)
  1326. that simply displays text on the screen, telling the user to look for a
  1327. README.DOC file, or something similar.
  1328.  
  1329.         Also, you could display information telling the end-user that
  1330. certain changes may/may not have been made to their AUTOEXEC or
  1331. CONFIG.SYS files.
  1332.  
  1333.         There are probably quite a number of uses for this feature. It
  1334. very basic, we know, in its implementation. It is meant to provide a
  1335. quick-fix for those who can use it. Keep an eye out for Version 5.0.
  1336. Here we hope to really dress things up a little.
  1337.  
  1338.  
  1339. 06/92
  1340.         Version 4.7 update.
  1341.  
  1342. FEATURES
  1343.  
  1344.         Now, when the end-user specifies the destination drive to
  1345. install to, Program Installer will replace your SET= statements for all
  1346. AUTOEXEC.BAT changes with the user's specified destination drive. Up to
  1347. this release, Program Installer simply added your SET= statements to the
  1348. user's AUTOEXEC.BAT file.
  1349.  
  1350.         Now, when you run LICENSEE to configure/register your code,
  1351. Program Installer FIRST asks you the name you wish to use for the title
  1352. of this installation program. Up to this release, you were only asked
  1353. for the information you wished to have replace the Copyright information
  1354. that is hard-coded for DataWorks, Inc. Now you can also replace the name
  1355. 'Program Installer Professional', if you desire to.
  1356.  
  1357.